home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #4 / Amiga Plus CD - 2000 - No. 4.iso / Tools / Dev / mpatrol / man / cat1 / mprof.1 < prev   
Encoding:
Text File  |  2000-05-27  |  5.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MPROF(1)                 mpatrol library                 MPROF(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        mprof  -  displays  profiling  information produced by the
  9.        mpatrol library
  10.  
  11. SSYYNNOOPPSSIISS
  12.        mmpprrooff [--aaccVV] [--nn _d_e_p_t_h] [_f_i_l_e]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        The mmpprrooff command is a tool designed to read  a  profiling
  16.        output  file  produced  by the mpatrol library and display
  17.        the profiling information that was obtained.  The  profil-
  18.        ing  information  includes  summaries of all of the memory
  19.        allocations listed by size and the function that allocated
  20.        them and a list of memory leaks with the call stack of the
  21.        allocating function.
  22.  
  23.        When the PPRROOFF option is used  with  the  mpatrol  library,
  24.        statistics  for all dynamic memory allocations and deallo-
  25.        cations are written to a profiling output file.  The  name
  26.        of  this  file can be changed with the PPRROOFFFFIILLEE option and
  27.        the frequency at which the file is written can  be  speci-
  28.        fied with the AAUUTTOOSSAAVVEE option.  The bounds for small allo-
  29.        cations, medium allocations, large allocations  and  extra
  30.        large  allocations can be set with the SSMMAALLLLBBOOUUNNDD, MMEEDDIIUUMM--
  31.        BBOOUUNNDD and LLAARRGGEEBBOOUUNNDD options.
  32.  
  33.        Only allocations and deallocations are recorded, with each
  34.        reallocation  being  treated as a deallocation immediately
  35.        followed by an allocation.   For  full  memory  allocation
  36.        profiling  support, call stack traversal must be supported
  37.        in the mpatrol library and all of  the  program's  symbols
  38.        must  have  been  successfully read by the mpatrol library
  39.        before the  program  was  run.   The  mmpprrooff  command  will
  40.        attempt  to compensate if either of these requirements are
  41.        not met, but the displayed tables may contain  less  mean-
  42.        ingful information.
  43.  
  44.        The _f_i_l_e argument must be a valid mpatrol profiling output
  45.        filename but if _f_i_l_e is omitted then mmpprrooff will  use  _m_p_a_-
  46.        _t_r_o_l_._o_u_t  as the name of the profiling output file to use.
  47.        If _f_i_l_e is given as _- then the standard input file  stream
  48.        will be used as the profiling output file.
  49.  
  50.        Much of the functionality of this tool is based upon mmpprrooff
  51.        by Benjamin Zorn and Paul Hilfinger, which was written  as
  52.        a  research  project  and  ran  on  MIPS,  SPARC  and  VAX
  53.        machines.  However, the profiling output files are  incom-
  54.        patible, the tables displayed have a different format, and
  55.        the way they are implemented is entirely different.
  56.  
  57. OOPPTTIIOONNSS
  58.        --aa     Specifies that different call sites from within the
  59.               same function are to be differentiated and that the
  60.               names of all functions  should  be  displayed  with
  61.  
  62.  
  63.  
  64. Release 1.2                12 May 2000                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MPROF(1)                 mpatrol library                 MPROF(1)
  71.  
  72.  
  73.               their  call site offset in bytes.  This affects the
  74.               direct allocation and memory leak tables.
  75.  
  76.        --cc     Specifies that certain tables should be  sorted  by
  77.               the  number  of allocations or deallocations rather
  78.               than the total number of bytes allocated or deallo-
  79.               cated.  This affects the direct allocation and mem-
  80.               ory leak tables.
  81.  
  82.        --nn _d_e_p_t_h
  83.               Specifies the maximum stack depth to use when  cal-
  84.               culating  if  one call site has the same call stack
  85.               as another call site.  This also specifies the max-
  86.               imum  number  of  functions  to  display  in a call
  87.               stack.  If _d_e_p_t_h is _0 then  the  call  stack  depth
  88.               will  be unlimited in size.  The default call stack
  89.               depth is _1.  This affects the memory leak table.
  90.  
  91.        --VV     Displays the version number of the mmpprrooff command.
  92.  
  93. SSEEEE AALLSSOO
  94.        mmppaattrrooll(1), mmlleeaakk(1), pprrooff(1), ggpprrooff(1), mmppaattrrooll(3).
  95.  
  96.        The mpatrol manual, reference card and FAQ.
  97.  
  98.        http://www.cbmamiga.demon.co.uk/mpatrol/
  99.  
  100. AAUUTTHHOORR
  101.        Graeme S. Roy <graeme@epc.co.uk>
  102.  
  103. CCOOPPYYRRIIGGHHTT
  104.        Copyright (C) 1997-2000 Graeme S. Roy <graeme@epc.co.uk>
  105.  
  106.        This library is free software;  you  can  redistribute  it
  107.        and/or  modify  it under the terms of the GNU Library Gen-
  108.        eral Public License as  published  by  the  Free  Software
  109.        Foundation;  either  version 2 of the License, or (at your
  110.        option) any later version.
  111.  
  112.        This library is distributed in the hope that  it  will  be
  113.        useful, but WITHOUT ANY WARRANTY; without even the implied
  114.        warranty of MERCHANTABILITY or FITNESS  FOR  A  PARTICULAR
  115.        PURPOSE.   See  the GNU Library General Public License for
  116.        more details.
  117.  
  118.        You should have received a copy of the GNU Library General
  119.        Public  License  along with this library; if not, write to
  120.        the Free Software Foundation, Inc., 59 Temple Place, Suite
  121.        330, Boston, MA 02111-1307, USA.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. Release 1.2                12 May 2000                          2
  131.  
  132.  
  133.